<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkItemFactory</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
<link rel="home" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkFileSelection.html" title="GtkFileSelection">
<link rel="next" href="GtkList.html" title="GtkList">
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="Builder.html" title="Interface builder">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="chapter" href="gtk-migrating-GtkBuilder.html" title="Migrating from libglade to GtkBuilder">
<link rel="chapter" href="gtk-migrating-tooltips.html" title="Migrating from GtkTooltips to GtkTooltip">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="api-index-full.html" title="Index of all symbols">
<link rel="index" href="api-index-deprecated.html" title="Index of deprecated symbols">
<link rel="index" href="api-index-2-2.html" title="Index of new symbols in 2.2">
<link rel="index" href="api-index-2-4.html" title="Index of new symbols in 2.4">
<link rel="index" href="api-index-2-6.html" title="Index of new symbols in 2.6">
<link rel="index" href="api-index-2-8.html" title="Index of new symbols in 2.8">
<link rel="index" href="api-index-2-10.html" title="Index of new symbols in 2.10">
<link rel="index" href="api-index-2-12.html" title="Index of new symbols in 2.12">
<link rel="index" href="api-index-2-14.html" title="Index of new symbols in 2.14">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkFileSelection.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="GtkList.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#GtkItemFactory.synopsis" class="shortcut">Top</a>
                 | 
                <a href="#GtkItemFactory.description" class="shortcut">Description</a>
                 | 
                <a href="#GtkItemFactory.object-hierarchy" class="shortcut">Object Hierarchy</a>
</td></tr>
</table>
<div class="refentry" lang="en">
<a name="GtkItemFactory"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkItemFactory.top_of_page"></a>GtkItemFactory</span></h2>
<p>GtkItemFactory — A factory for menus</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="GtkItemFactory.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">

#include &lt;gtk/gtk.h&gt;

                    <a class="link" href="GtkItemFactory.html#GtkItemFactory-struct" title="GtkItemFactory">GtkItemFactory</a>;
void                (<a class="link" href="GtkItemFactory.html#GtkPrintFunc" title="GtkPrintFunc ()">*GtkPrintFunc</a>)                     (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> func_data,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *str);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *             (<a class="link" href="GtkItemFactory.html#GtkTranslateFunc" title="GtkTranslateFunc ()">*GtkTranslateFunc</a>)                 (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> func_data);
void                (<a class="link" href="GtkItemFactory.html#GtkItemFactoryCallback" title="GtkItemFactoryCallback ()">*GtkItemFactoryCallback</a>)           ();
void                (<a class="link" href="GtkItemFactory.html#GtkItemFactoryCallback1" title="GtkItemFactoryCallback1 ()">*GtkItemFactoryCallback1</a>)          (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> callback_action,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
void                (<a class="link" href="GtkItemFactory.html#GtkItemFactoryCallback2" title="GtkItemFactoryCallback2 ()">*GtkItemFactoryCallback2</a>)          (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> callback_action);
                    <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry">GtkItemFactoryEntry</a>;
                    <a class="link" href="GtkItemFactory.html#GtkItemFactoryItem" title="GtkItemFactoryItem">GtkItemFactoryItem</a>;
<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a>*     <a class="link" href="GtkItemFactory.html#gtk-item-factory-new" title="gtk_item_factory_new ()">gtk_item_factory_new</a>                (<a
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
>GType</a> container_type,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
                                                         <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group);
void                <a class="link" href="GtkItemFactory.html#gtk-item-factory-construct" title="gtk_item_factory_construct ()">gtk_item_factory_construct</a>          (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
>GType</a> container_type,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
                                                         <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group);
void                <a class="link" href="GtkItemFactory.html#gtk-item-factory-add-foreign" title="gtk_item_factory_add_foreign ()">gtk_item_factory_add_foreign</a>        (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *accel_widget,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *full_path,
                                                         <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> keyval,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GdkModifierType"
>GdkModifierType</a> modifiers);
<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a>*     <a class="link" href="GtkItemFactory.html#gtk-item-factory-from-widget" title="gtk_item_factory_from_widget ()">gtk_item_factory_from_widget</a>        (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        <a class="link" href="GtkItemFactory.html#gtk-item-factory-path-from-widget" title="gtk_item_factory_path_from_widget ()">gtk_item_factory_path_from_widget</a>   (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a class="link" href="GtkItemFactory.html#gtk-item-factory-get-item" title="gtk_item_factory_get_item ()">gtk_item_factory_get_item</a>           (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);
<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a class="link" href="GtkItemFactory.html#gtk-item-factory-get-widget" title="gtk_item_factory_get_widget ()">gtk_item_factory_get_widget</a>         (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);
<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a class="link" href="GtkItemFactory.html#gtk-item-factory-get-widget-by-action" title="gtk_item_factory_get_widget_by_action ()">gtk_item_factory_get_widget_by_action</a>
                                                        (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> action);
<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          <a class="link" href="GtkItemFactory.html#gtk-item-factory-get-item-by-action" title="gtk_item_factory_get_item_by_action ()">gtk_item_factory_get_item_by_action</a> (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> action);
void                <a class="link" href="GtkItemFactory.html#gtk-item-factory-create-item" title="gtk_item_factory_create_item ()">gtk_item_factory_create_item</a>        (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entry,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> callback_type);
void                <a class="link" href="GtkItemFactory.html#gtk-item-factory-create-items" title="gtk_item_factory_create_items ()">gtk_item_factory_create_items</a>       (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
                                                         <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entries,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data);
void                <a class="link" href="GtkItemFactory.html#gtk-item-factory-create-items-ac" title="gtk_item_factory_create_items_ac ()">gtk_item_factory_create_items_ac</a>    (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
                                                         <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entries,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> callback_type);
void                <a class="link" href="GtkItemFactory.html#gtk-item-factory-delete-item" title="gtk_item_factory_delete_item ()">gtk_item_factory_delete_item</a>        (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);
void                <a class="link" href="GtkItemFactory.html#gtk-item-factory-delete-entry" title="gtk_item_factory_delete_entry ()">gtk_item_factory_delete_entry</a>       (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entry);
void                <a class="link" href="GtkItemFactory.html#gtk-item-factory-delete-entries" title="gtk_item_factory_delete_entries ()">gtk_item_factory_delete_entries</a>     (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
                                                         <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entries);
void                <a class="link" href="GtkItemFactory.html#gtk-item-factory-popup" title="gtk_item_factory_popup ()">gtk_item_factory_popup</a>              (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> x,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> y,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> mouse_button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);
void                <a class="link" href="GtkItemFactory.html#gtk-item-factory-popup-with-data" title="gtk_item_factory_popup_with_data ()">gtk_item_factory_popup_with_data</a>    (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> popup_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
>GDestroyNotify</a> destroy,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> x,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> y,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> mouse_button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>            <a class="link" href="GtkItemFactory.html#gtk-item-factory-popup-data" title="gtk_item_factory_popup_data ()">gtk_item_factory_popup_data</a>         (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>            <a class="link" href="GtkItemFactory.html#gtk-item-factory-popup-data-from-widget" title="gtk_item_factory_popup_data_from_widget ()">gtk_item_factory_popup_data_from_widget</a>
                                                        (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);
<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a>*     <a class="link" href="GtkItemFactory.html#gtk-item-factory-from-path" title="gtk_item_factory_from_path ()">gtk_item_factory_from_path</a>          (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);
void                <a class="link" href="GtkItemFactory.html#gtk-item-factory-create-menu-entries" title="gtk_item_factory_create_menu_entries ()">gtk_item_factory_create_menu_entries</a>
                                                        (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
                                                         GtkMenuEntry *entries);
void                <a class="link" href="GtkItemFactory.html#gtk-item-factories-path-delete" title="gtk_item_factories_path_delete ()">gtk_item_factories_path_delete</a>      (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *ifactory_path,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);
void                <a class="link" href="GtkItemFactory.html#gtk-item-factory-set-translate-func" title="gtk_item_factory_set_translate_func ()">gtk_item_factory_set_translate_func</a> (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a class="link" href="GtkItemFactory.html#GtkTranslateFunc" title="GtkTranslateFunc ()">GtkTranslateFunc</a> func,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
>GDestroyNotify</a> notify);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkItemFactory.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
  <a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
   +----<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
               +----GtkItemFactory
</pre>
</div>
<div class="refsect1" lang="en">
<a name="GtkItemFactory.description"></a><h2>Description</h2>
<p>
As of GTK+ 2.4, <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a> has been deprecated in favour of <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a>.
</p>
</div>
<div class="refsect1" lang="en">
<a name="GtkItemFactory.details"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="GtkItemFactory-struct"></a><h3>GtkItemFactory</h3>
<pre class="programlisting">typedef struct _GtkItemFactory GtkItemFactory;</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkItemFactory</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkPrintFunc"></a><h3>GtkPrintFunc ()</h3>
<pre class="programlisting">void                (*GtkPrintFunc)                     (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> func_data,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *str);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkPrintFunc</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>func_data</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>str</code></em> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkTranslateFunc"></a><h3>GtkTranslateFunc ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *             (*GtkTranslateFunc)                 (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> func_data);</pre>
<p>
The function used to translate messages in e.g. <a class="link" href="gtk-Themeable-Stock-Images.html#GtkIconFactory"><span class="type">GtkIconFactory</span></a>
and <a class="link" href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
<td>The id of the message. In <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a> this will be a path
  from a <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>, in <a class="link" href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a>, it will be a label
  or tooltip from a <a class="link" href="GtkActionGroup.html#GtkActionEntry" title="GtkActionEntry"><span class="type">GtkActionEntry</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func_data</code></em> :</span></p></td>
<td>user data passed in when registering the function
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the translated message
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkItemFactoryCallback"></a><h3>GtkItemFactoryCallback ()</h3>
<pre class="programlisting">void                (*GtkItemFactoryCallback)           ();</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkItemFactoryCallback</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkItemFactoryCallback1"></a><h3>GtkItemFactoryCallback1 ()</h3>
<pre class="programlisting">void                (*GtkItemFactoryCallback1)          (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> callback_action,
                                                         <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkItemFactoryCallback1</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_data</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_action</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkItemFactoryCallback2"></a><h3>GtkItemFactoryCallback2 ()</h3>
<pre class="programlisting">void                (*GtkItemFactoryCallback2)          (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> callback_action);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkItemFactoryCallback2</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_data</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_action</code></em> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkItemFactoryEntry"></a><h3>GtkItemFactoryEntry</h3>
<pre class="programlisting">typedef struct {
  gchar *path;
  gchar *accelerator;

  GtkItemFactoryCallback callback;
  guint			 callback_action;

  /* possible values:
   * NULL		-&gt; "&lt;Item&gt;"
   * ""			-&gt; "&lt;Item&gt;"
   * "&lt;Title&gt;"		-&gt; create a title item
   * "&lt;Item&gt;"		-&gt; create a simple item
   * "&lt;ImageItem&gt;"	-&gt; create an item holding an image
   * "&lt;StockItem&gt;"	-&gt; create an item holding a stock image
   * "&lt;CheckItem&gt;"	-&gt; create a check item
   * "&lt;ToggleItem&gt;"	-&gt; create a toggle item
   * "&lt;RadioItem&gt;"	-&gt; create a radio item
   * &lt;path&gt;		-&gt; path of a radio item to link against
   * "&lt;Separator&gt;"	-&gt; create a separator
   * "&lt;Tearoff&gt;"	-&gt; create a tearoff separator
   * "&lt;Branch&gt;"		-&gt; create an item to hold sub items
   * "&lt;LastBranch&gt;"	-&gt; create a right justified item to hold sub items
   */
  gchar		 *item_type;

  /* Extra data for some item types:
   *  ImageItem  -&gt; pointer to inlined pixbuf stream
   *  StockItem  -&gt; name of stock item
   */
  gconstpointer extra_data;
} GtkItemFactoryEntry;
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkItemFactoryEntry</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="GtkItemFactoryItem"></a><h3>GtkItemFactoryItem</h3>
<pre class="programlisting">typedef struct {
  gchar *path;
  GSList *widgets;
} GtkItemFactoryItem;
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkItemFactoryItem</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-new"></a><h3>gtk_item_factory_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a>*     gtk_item_factory_new                (<a
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
>GType</a> container_type,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
                                                         <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_new</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Creates a new <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>.
</p>
<p>
Beware that the returned object does not have a floating reference.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>container_type</code></em> :</span></p></td>
<td> the kind of menu to create; can be
   <span class="type">GTK_TYPE_MENU_BAR</span>, <span class="type">GTK_TYPE_MENU</span> or <span class="type">GTK_TYPE_OPTION_MENU</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
<td> the factory path of the new item factory, a string of the form 
   <code class="literal">"&lt;name&gt;"</code>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_group</code></em> :</span></p></td>
<td> a <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> to which the accelerators for the
   menu items will be added, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a> to create a new one
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a new <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-construct"></a><h3>gtk_item_factory_construct ()</h3>
<pre class="programlisting">void                gtk_item_factory_construct          (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"
>GType</a> container_type,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path,
                                                         <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_construct</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Initializes an item factory.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>container_type</code></em> :</span></p></td>
<td> the kind of menu to create; can be
   <span class="type">GTK_TYPE_MENU_BAR</span>, <span class="type">GTK_TYPE_MENU</span> or <span class="type">GTK_TYPE_OPTION_MENU</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
<td> the factory path of <em class="parameter"><code>ifactory</code></em>, a string of the form 
   <code class="literal">"&lt;name&gt;"</code>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_group</code></em> :</span></p></td>
<td> a <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> to which the accelerators for the
   menu items will be added, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a> to create a new one
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-add-foreign"></a><h3>gtk_item_factory_add_foreign ()</h3>
<pre class="programlisting">void                gtk_item_factory_add_foreign        (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *accel_widget,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *full_path,
                                                         <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup">GtkAccelGroup</a> *accel_group,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> keyval,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Windows.html#GdkModifierType"
>GdkModifierType</a> modifiers);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_add_foreign</code> has been deprecated since version 2.4 and should not be used in newly-written code. The recommended API for this purpose are the functions 
<a class="link" href="GtkMenuItem.html#gtk-menu-item-set-accel-path" title="gtk_menu_item_set_accel_path ()"><code class="function">gtk_menu_item_set_accel_path()</code></a> and <a class="link" href="GtkWidget.html#gtk-widget-set-accel-path" title="gtk_widget_set_accel_path ()"><code class="function">gtk_widget_set_accel_path()</code></a>; don't 
use <a class="link" href="GtkItemFactory.html#gtk-item-factory-add-foreign" title="gtk_item_factory_add_foreign ()"><code class="function">gtk_item_factory_add_foreign()</code></a> in new code, since it is likely to
be removed in the future.</p>
</div>
<p>
Installs an accelerator for <em class="parameter"><code>accel_widget</code></em> in <em class="parameter"><code>accel_group</code></em>, that causes
the ::activate signal to be emitted if the accelerator is activated.
</p>
<p>
This function can be used to make widgets participate in the accel
saving/restoring functionality provided by <a class="link" href="gtk-Accelerator-Maps.html#gtk-accel-map-save" title="gtk_accel_map_save ()"><code class="function">gtk_accel_map_save()</code></a> and
<a class="link" href="gtk-Accelerator-Maps.html#gtk-accel-map-load" title="gtk_accel_map_load ()"><code class="function">gtk_accel_map_load()</code></a>, even if they haven't been created by an item
factory.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_widget</code></em> :</span></p></td>
<td>     widget to install an accelerator on 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>full_path</code></em> :</span></p></td>
<td>	      the full path for the <em class="parameter"><code>accel_widget</code></em> 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>accel_group</code></em> :</span></p></td>
<td>      the accelerator group to install the accelerator in
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>keyval</code></em> :</span></p></td>
<td>           key value of the accelerator
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>modifiers</code></em> :</span></p></td>
<td>        modifier combination of the accelerator
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-from-widget"></a><h3>gtk_item_factory_from_widget ()</h3>
<pre class="programlisting"><a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a>*     gtk_item_factory_from_widget        (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_from_widget</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Obtains the item factory from which a widget was created.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td> a widget
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the item factory from which <em class="parameter"><code>widget</code></em> was created, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-path-from-widget"></a><h3>gtk_item_factory_path_from_widget ()</h3>
<pre class="programlisting">const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a>*        gtk_item_factory_path_from_widget   (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_path_from_widget</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
If <em class="parameter"><code>widget</code></em> has been created by an item factory, returns the full path
to it. (The full path of a widget is the concatenation of the factory 
path specified in <a class="link" href="GtkItemFactory.html#gtk-item-factory-new" title="gtk_item_factory_new ()"><code class="function">gtk_item_factory_new()</code></a> with the path specified in the 
<a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a> from which the widget was created.)</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td> a widget
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the full path to <em class="parameter"><code>widget</code></em> if it has been created by an item
  factory, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a> otherwise. This value is owned by GTK+ and must not be
  modified or freed.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-get-item"></a><h3>gtk_item_factory_get_item ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_item_factory_get_item           (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_get_item</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Obtains the menu item which corresponds to <em class="parameter"><code>path</code></em>. 
</p>
<p>
If the widget corresponding to <em class="parameter"><code>path</code></em> is a menu item which opens a 
submenu, then the item is returned. If you are interested in the submenu, 
use <a class="link" href="GtkItemFactory.html#gtk-item-factory-get-widget" title="gtk_item_factory_get_widget ()"><code class="function">gtk_item_factory_get_widget()</code></a> instead.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
<td> the path to the menu item
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the menu item for the given path, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a> if <em class="parameter"><code>path</code></em> doesn't
  lead to a menu item
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-get-widget"></a><h3>gtk_item_factory_get_widget ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_item_factory_get_widget         (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_get_widget</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Obtains the widget which corresponds to <em class="parameter"><code>path</code></em>. 
</p>
<p>
If the widget corresponding to <em class="parameter"><code>path</code></em> is a menu item which opens a 
submenu, then the submenu is returned. If you are interested in the menu 
item, use <a class="link" href="GtkItemFactory.html#gtk-item-factory-get-item" title="gtk_item_factory_get_item ()"><code class="function">gtk_item_factory_get_item()</code></a> instead.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
<td> the path to the widget
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the widget for the given path, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a> if <em class="parameter"><code>path</code></em> doesn't lead
  to a widget
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-get-widget-by-action"></a><h3>gtk_item_factory_get_widget_by_action ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_item_factory_get_widget_by_action
                                                        (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> action);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_get_widget_by_action</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Obtains the widget which was constructed from the <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>
with the given <em class="parameter"><code>action</code></em>.
</p>
<p>
If there are multiple items with the same action, the result is 
undefined.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td> an action as specified in the <em class="parameter"><code>callback_action</code></em> field
  of <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the widget which corresponds to the given action, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>
  if no widget was found
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-get-item-by-action"></a><h3>gtk_item_factory_get_item_by_action ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>*          gtk_item_factory_get_item_by_action (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> action);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_get_item_by_action</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Obtains the menu item which was constructed from the first 
<a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a> with the given <em class="parameter"><code>action</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td> an action as specified in the <em class="parameter"><code>callback_action</code></em> field
  of <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the menu item which corresponds to the given action, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a>
  if no menu item was found
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-create-item"></a><h3>gtk_item_factory_create_item ()</h3>
<pre class="programlisting">void                gtk_item_factory_create_item        (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entry,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> callback_type);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_create_item</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Creates an item for <em class="parameter"><code>entry</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td>
<td> the <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a> to create an item for
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_data</code></em> :</span></p></td>
<td> data passed to the callback function of <em class="parameter"><code>entry</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_type</code></em> :</span></p></td>
<td> 1 if the callback function of <em class="parameter"><code>entry</code></em> is of type
   <a class="link" href="GtkItemFactory.html#GtkItemFactoryCallback1" title="GtkItemFactoryCallback1 ()"><span class="type">GtkItemFactoryCallback1</span></a>, 2 if it is of type <a class="link" href="GtkItemFactory.html#GtkItemFactoryCallback2" title="GtkItemFactoryCallback2 ()"><span class="type">GtkItemFactoryCallback2</span></a> 
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-create-items"></a><h3>gtk_item_factory_create_items ()</h3>
<pre class="programlisting">void                gtk_item_factory_create_items       (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
                                                         <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entries,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_create_items</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Creates the menu items from the <em class="parameter"><code>entries</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_entries</code></em> :</span></p></td>
<td> the length of <em class="parameter"><code>entries</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>entries</code></em> :</span></p></td>
<td> an array of <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>s whose <em class="parameter"><code>callback</code></em> members
   must by of type <a class="link" href="GtkItemFactory.html#GtkItemFactoryCallback1" title="GtkItemFactoryCallback1 ()"><span class="type">GtkItemFactoryCallback1</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_data</code></em> :</span></p></td>
<td> data passed to the callback functions of all entries
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-create-items-ac"></a><h3>gtk_item_factory_create_items_ac ()</h3>
<pre class="programlisting">void                gtk_item_factory_create_items_ac    (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
                                                         <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entries,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> callback_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> callback_type);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_create_items_ac</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Creates the menu items from the <em class="parameter"><code>entries</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_entries</code></em> :</span></p></td>
<td> the length of <em class="parameter"><code>entries</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>entries</code></em> :</span></p></td>
<td> an array of <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>s 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_data</code></em> :</span></p></td>
<td> data passed to the callback functions of all entries
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback_type</code></em> :</span></p></td>
<td> 1 if the callback functions in <em class="parameter"><code>entries</code></em> are of type
   <a class="link" href="GtkItemFactory.html#GtkItemFactoryCallback1" title="GtkItemFactoryCallback1 ()"><span class="type">GtkItemFactoryCallback1</span></a>, 2 if they are of type <a class="link" href="GtkItemFactory.html#GtkItemFactoryCallback2" title="GtkItemFactoryCallback2 ()"><span class="type">GtkItemFactoryCallback2</span></a> 
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-delete-item"></a><h3>gtk_item_factory_delete_item ()</h3>
<pre class="programlisting">void                gtk_item_factory_delete_item        (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_delete_item</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Deletes the menu item which was created for <em class="parameter"><code>path</code></em> by the given
item factory.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
<td> a path
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-delete-entry"></a><h3>gtk_item_factory_delete_entry ()</h3>
<pre class="programlisting">void                gtk_item_factory_delete_entry       (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entry);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_delete_entry</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Deletes the menu item which was created from <em class="parameter"><code>entry</code></em> by the given
item factory.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>entry</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-delete-entries"></a><h3>gtk_item_factory_delete_entries ()</h3>
<pre class="programlisting">void                gtk_item_factory_delete_entries     (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
                                                         <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry">GtkItemFactoryEntry</a> *entries);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_delete_entries</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Deletes the menu items which were created from the <em class="parameter"><code>entries</code></em> by the given
item factory.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_entries</code></em> :</span></p></td>
<td> the length of <em class="parameter"><code>entries</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>entries</code></em> :</span></p></td>
<td> an array of <a class="link" href="GtkItemFactory.html#GtkItemFactoryEntry" title="GtkItemFactoryEntry"><span class="type">GtkItemFactoryEntry</span></a>s 
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-popup"></a><h3>gtk_item_factory_popup ()</h3>
<pre class="programlisting">void                gtk_item_factory_popup              (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> x,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> y,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> mouse_button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_popup</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Pops up the menu constructed from the item factory at (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>).
</p>
<p>
The <em class="parameter"><code>mouse_button</code></em> parameter should be the mouse button pressed to initiate
the menu popup. If the menu popup was initiated by something other than
a mouse button press, such as a mouse button release or a keypress,
<em class="parameter"><code>mouse_button</code></em> should be 0.
</p>
<p>
The <em class="parameter"><code>time_</code></em> parameter should be the time stamp of the event that
initiated the popup. If such an event is not available, use
<a class="link" href="gtk-General.html#gtk-get-current-event-time" title="gtk_get_current_event_time ()"><code class="function">gtk_get_current_event_time()</code></a> instead.
</p>
<p>
The operation of the <em class="parameter"><code>mouse_button</code></em> and the <em class="parameter"><code>time_</code></em> parameter is the same
as the <em class="parameter"><code>button</code></em> and <em class="parameter"><code>activation_time</code></em> parameters for <a class="link" href="GtkMenu.html#gtk-menu-popup" title="gtk_menu_popup ()"><code class="function">gtk_menu_popup()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a> of type <span class="type">GTK_TYPE_MENU</span> (see <a class="link" href="GtkItemFactory.html#gtk-item-factory-new" title="gtk_item_factory_new ()"><code class="function">gtk_item_factory_new()</code></a>)
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
<td> the x position 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
<td> the y position
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>mouse_button</code></em> :</span></p></td>
<td> the mouse button which was pressed to initiate the popup
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
<td> the time at which the activation event occurred
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-popup-with-data"></a><h3>gtk_item_factory_popup_with_data ()</h3>
<pre class="programlisting">void                gtk_item_factory_popup_with_data    (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> popup_data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
>GDestroyNotify</a> destroy,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> x,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> y,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> mouse_button,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"
>guint32</a> time_);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_popup_with_data</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Pops up the menu constructed from the item factory at (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>). Callbacks
can access the <em class="parameter"><code>popup_data</code></em> while the menu is posted via 
<a class="link" href="GtkItemFactory.html#gtk-item-factory-popup-data" title="gtk_item_factory_popup_data ()"><code class="function">gtk_item_factory_popup_data()</code></a> and <a class="link" href="GtkItemFactory.html#gtk-item-factory-popup-data-from-widget" title="gtk_item_factory_popup_data_from_widget ()"><code class="function">gtk_item_factory_popup_data_from_widget()</code></a>.
</p>
<p>
The <em class="parameter"><code>mouse_button</code></em> parameter should be the mouse button pressed to initiate
the menu popup. If the menu popup was initiated by something other than
a mouse button press, such as a mouse button release or a keypress,
<em class="parameter"><code>mouse_button</code></em> should be 0.
</p>
<p>
The <em class="parameter"><code>time_</code></em> parameter should be the time stamp of the event that
initiated the popup. If such an event is not available, use
<a class="link" href="gtk-General.html#gtk-get-current-event-time" title="gtk_get_current_event_time ()"><code class="function">gtk_get_current_event_time()</code></a> instead.
</p>
<p>
The operation of the <em class="parameter"><code>mouse_button</code></em> and the <em class="parameter"><code>time_</code></em> parameters is the same
as the <em class="parameter"><code>button</code></em> and <em class="parameter"><code>activation_time</code></em> parameters for <a class="link" href="GtkMenu.html#gtk-menu-popup" title="gtk_menu_popup ()"><code class="function">gtk_menu_popup()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a> of type <span class="type">GTK_TYPE_MENU</span> (see <a class="link" href="GtkItemFactory.html#gtk-item-factory-new" title="gtk_item_factory_new ()"><code class="function">gtk_item_factory_new()</code></a>)
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>popup_data</code></em> :</span></p></td>
<td> data available for callbacks while the menu is posted
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
><span class="type">GDestroyNotify</span></a> function to be called on <em class="parameter"><code>popup_data</code></em> when
 the menu is unposted
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
<td> the x position 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
<td> the y position
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>mouse_button</code></em> :</span></p></td>
<td> the mouse button which was pressed to initiate the popup
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
<td> the time at which the activation event occurred
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-popup-data"></a><h3>gtk_item_factory_popup_data ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>            gtk_item_factory_popup_data         (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_popup_data</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Obtains the <em class="parameter"><code>popup_data</code></em> which was passed to 
<a class="link" href="GtkItemFactory.html#gtk-item-factory-popup-with-data" title="gtk_item_factory_popup_with_data ()"><code class="function">gtk_item_factory_popup_with_data()</code></a>. This data is available until the menu
is popped down again.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <em class="parameter"><code>popup_data</code></em> associated with <em class="parameter"><code>ifactory</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-popup-data-from-widget"></a><h3>gtk_item_factory_popup_data_from_widget ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a>            gtk_item_factory_popup_data_from_widget
                                                        (<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_popup_data_from_widget</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Obtains the <em class="parameter"><code>popup_data</code></em> which was passed to 
<a class="link" href="GtkItemFactory.html#gtk-item-factory-popup-with-data" title="gtk_item_factory_popup_with_data ()"><code class="function">gtk_item_factory_popup_with_data()</code></a>. This data is available until the menu
is popped down again.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td> a widget
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <em class="parameter"><code>popup_data</code></em> associated with the item factory from
  which <em class="parameter"><code>widget</code></em> was created, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a> if <em class="parameter"><code>widget</code></em> wasn't created
  by an item factory
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-from-path"></a><h3>gtk_item_factory_from_path ()</h3>
<pre class="programlisting"><a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a>*     gtk_item_factory_from_path          (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_from_path</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Finds an item factory which has been constructed using the 
<code class="literal">"&lt;name&gt;"</code> prefix of <em class="parameter"><code>path</code></em> as the <em class="parameter"><code>path</code></em> argument 
for <a class="link" href="GtkItemFactory.html#gtk-item-factory-new" title="gtk_item_factory_new ()"><code class="function">gtk_item_factory_new()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
<td> a string starting with a factory path of the form 
  <code class="literal">"&lt;name&gt;"</code>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a> created for the given factory path, or <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a> 
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-create-menu-entries"></a><h3>gtk_item_factory_create_menu_entries ()</h3>
<pre class="programlisting">void                gtk_item_factory_create_menu_entries
                                                        (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"
>guint</a> n_entries,
                                                         GtkMenuEntry *entries);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_create_menu_entries</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Creates the menu items from the <em class="parameter"><code>entries</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>n_entries</code></em> :</span></p></td>
<td> the length of <em class="parameter"><code>entries</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>entries</code></em> :</span></p></td>
<td> an array of <span class="type">GtkMenuEntry</span>s 
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factories-path-delete"></a><h3>gtk_item_factories_path_delete ()</h3>
<pre class="programlisting">void                gtk_item_factories_path_delete      (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *ifactory_path,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *path);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factories_path_delete</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Deletes all widgets constructed from the specified path.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory_path</code></em> :</span></p></td>
<td> a factory path to prepend to <em class="parameter"><code>path</code></em>. May be <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL--CAPS"
><code class="literal">NULL</code></a> if <em class="parameter"><code>path</code></em>
  starts with a factory path
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>path</code></em> :</span></p></td>
<td> a path 
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="gtk-item-factory-set-translate-func"></a><h3>gtk_item_factory_set_translate_func ()</h3>
<pre class="programlisting">void                gtk_item_factory_set_translate_func (<a class="link" href="GtkItemFactory.html" title="GtkItemFactory">GtkItemFactory</a> *ifactory,
                                                         <a class="link" href="GtkItemFactory.html#GtkTranslateFunc" title="GtkTranslateFunc ()">GtkTranslateFunc</a> func,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
>GDestroyNotify</a> notify);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_item_factory_set_translate_func</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a> instead.</p>
</div>
<p>
Sets a function to be used for translating the path elements before they
are displayed.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>ifactory</code></em> :</span></p></td>
<td> a <a class="link" href="GtkItemFactory.html" title="GtkItemFactory"><span class="type">GtkItemFactory</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
<td> the <a class="link" href="GtkItemFactory.html#GtkTranslateFunc" title="GtkTranslateFunc ()"><span class="type">GtkTranslateFunc</span></a> function to be used to translate path elements 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
<td> data to pass to <em class="parameter"><code>func</code></em> and <em class="parameter"><code>notify</code></em>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
<td> a <a
href="/usr/share/gtk-doc/html/glib/glib-Datasets.html#GDestroyNotify"
><span class="type">GDestroyNotify</span></a> function to be called when <em class="parameter"><code>ifactory</code></em> is 
  destroyed and when the translation function is changed again
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.11</div>
</body>
</html>
